home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / os2 / mdf121.arj / MDFL121.ZIP / MDFL_ITA.DOC < prev    next >
Text File  |  1994-06-07  |  4KB  |  100 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                        MDFLIB
  8.                                     Versione 1.21
  9.  
  10.                              (C) 1994/95 Maurizio Giunti
  11.  
  12.  
  13.  
  14.        Libreria C++  che consente  di applicare  i  files *.MDF  creati  con
  15.        versioni REGISTRATE di MDIFF/MDIFF2. Versioni Dos e OS/2  2.xx 32bit.
  16.        MDFLIB e' liberamente utilizzabile e non e' richiesto  alcun compenso
  17.        o royalty. Chiunque  puo' redistribuire MDFLIB  a condizione che  non
  18.        richieda alcuna somma  di denaro  in cambio, fatta  eccezione per  le
  19.        spese di  copia e/o  distribuzione  che devono  essere  adeguatamente
  20.        documentate.
  21.  
  22.        ATTENZIONE:
  23.        Le librerie  fornite funzionano  solo con  files  *.MDF prodotti  con
  24.        copie REGISTRATE di MDIFF o MDIFF2.
  25.  
  26.        La classe MPatch:
  27.        Per utilizzare la classe MPatch non e' necessario sapere come opera o
  28.        cosa contiene,  e'  sufficiente capire  come  operano i  suoi  membri
  29.        pubblici.
  30.  
  31.        MPatch()
  32.        E' il  constructor,  inizializza  i dati  privati.  Non  deve  essere
  33.        modificato.
  34.  
  35.        void SetRate(short r)
  36.        Cambia il rating di chiamata del metodo Show(). Vedi piu' avanti.
  37.  
  38.        short MDFPatch(char *dif, char *old, char *new)
  39.        E' la funzione chiave,  prende come parametri i  nomi dei 3 files  da
  40.        trattare: il file di  differenza, il file di  partenza e il nome  del
  41.        file da produrre. Attenzione: old e new non devono puntare a stringhe
  42.        uguali. Se old  o new  contengono stringhe  nulle ("\0")  i nomi  dei
  43.        files vengono presi dal file di differenza. La funzione ritorna  0 se
  44.        tutto e' andato a buon fine o un intero positivo in caso di errore.
  45.  
  46.        char *LastError()
  47.        Se si e'  verificato un  errore nell'uso  di MDFPatch(),  LastError()
  48.        ritorna un puntatore  ad una stringa  che spiega  l'errore che si  e'
  49.        verificato.
  50.  
  51.        void Show_start()
  52.        void Show()
  53.        void Show_end()
  54.        Queste tre funzioni vengono utilizzate per visualizzare  dei messaggi
  55.        durante l'applicazione della patch. La Show_start()  viene richiamata
  56.        nel momento in cui la MDFPatch(),  ultimati i controlli dei  files su
  57.        cui deve lavorare, inizia ad applicare la patch. La  Show_end() viene
  58.        richiamata  al  termine  dell'operazione,  mentre  la   Show()  viene
  59.        richiamata durante  l'esecuzione  dell'operazione.  Le volte  in  cui
  60.        Show() viene richiamata dipendono  dal valore settato dalla  funzione
  61.  
  62.  
  63.  
  64.  
  65.  
  66.        SetRate().Queste  3  funzioni  sono  virtuali,  quindi,  per  poterle
  67.        adattare, e' necessario ereditare la classe. Vedi anche SAMPLE.CPP.
  68.  
  69.  
  70.        Tavola degli errori
  71.        Ecco i codici di errore che  puo' ritornare la funzione  MDFPatch() e
  72.        le  stringhe  corrispondentemente  riportate  dalla  LastError()  (le
  73.        virgolette sono ovviamente escluse):
  74.  
  75.           Codice                     Descrizione
  76.              0      "OK!"
  77.              1      "Out of memory !"
  78.              2      "Can't open MDF file !"
  79.              3      "Invalid MDF file !"
  80.              4      "MDF file version mismatch !"
  81.              5      "UNREGISTERED !"
  82.              6      "Bad or incorrect OLD file !"
  83.              7      "Can't open OLD file !"
  84.              8      "Can't create NEW file !"
  85.              9      "General failure: NEW file corrupted !"
  86.             10      "OLD and NEW can't be the same file !"
  87.  
  88.  
  89.  
  90.        Per qualsiasi dubbio o perplessita', contattatemi:
  91.  
  92.                                    Maurizio Giunti
  93.                                 Via G.B. Foggini, 24
  94.                                     50142 Firenze
  95.                                         Italy
  96.  
  97.  
  98.                                        E-Mail:
  99.                                 Fidonet: 2:332/102.3
  100.                           Internet: Giunti@stat.ds.unifi.it